home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 43.zip / CU Amiga 32.adf / PowerPacker.doc / PowerPacker.doc
Text File  |  1978-01-18  |  37KB  |  785 lines
  1.  
  2.  
  3.  
  4.                         ›1mPowerPacker Professional 3.0b›0m
  5.  
  6.                       Copyright © 1990  PowerPeak & UGA
  7.                              All rights reserved
  8.  
  9.    One time permission is given to CU AMIGA for use on their MAY coverdisk
  10.    -----------------------------------------------------------------------       
  11.  
  12.  
  13. ›1mNOTE›0m
  14. ›1m====›0m
  15.  
  16.      I wish this paragraph wasn't necessary, but...
  17.  
  18.      PowerPacker was first released as shareware and although response was
  19. not bad it was ridiculous compared to how many people actually used
  20. PowerPacker.  Therefore I have decided to release PowerPacker commercially,
  21. the price is about the same as the shareware version, but now you pay first
  22. and use it later.  I have really put an enormous (and I mean ENORMOUS !)
  23. amount of time and effort into creating this product and I have tried to make
  24. this program as good as I possibly can.  PowerPacker is released on a low
  25. budget label that gives excellent conditions to the programmer, so if you buy
  26. this program you not only pay less, but you are really supporting the
  27. programmer and not just the software house.  The program is not copy
  28. protected, so make a backup copy or install it on your harddisk but PLEASE do
  29. not pirate this program or copy it for your friends, the price has been kept
  30. so low that everybody can afford it.  Thank you.
  31.  
  32.  
  33. ›1mPreface›0m
  34. ›1m=======›0m
  35.  
  36.      Thank you for buying PowerPacker Professional 3.0b, PowerPeak's command
  37. and data cruncher for the Amiga.  This version of PowerPacker is no longer
  38. shareware, it is a commercial product. Use without paying is both illegal and
  39. immoral.
  40.  
  41.      If you like to distribute Powerpacker Pro in your country or you want
  42. to become a UGA dealer then please send your request to :
  43.  
  44.        UGA Software
  45.         Po box 881
  46.          3700 AW  Zeist
  47.           The Netherlands
  48.  
  49.            or fax: +31 30-313968  or +31 4908 549
  50.  
  51.  
  52.      If you want to use PowerPacker or PowerPacker related programs/routines
  53. for commercial purposes you need a written permission.
  54.  
  55.      Write to the following address:
  56.  
  57.                                 Nico François
  58.                                 Corbielaan 13
  59.                                 B-3060 Bertem
  60.                                 BELGIUM
  61.  
  62.      PowerPacker is AmigaDOS Release 2 (Kickstart & Workbench 2.0) compatible.
  63.  
  64.  
  65. ›1mContents›0m
  66. ›1m========›0m
  67.  
  68. 1. The Packer
  69.      1.1 An introduction
  70.      1.2 The file requester
  71.      1.3 The basic menus
  72.           1.3.1 Project
  73.           1.3.2 Prefs
  74.           1.3.3 Crypt
  75.  
  76. 2. Recrunch
  77.      2.1 How ?
  78.  
  79. 3. The HunkLab
  80.      3.1 Preferences
  81.      3.2 Process file
  82.  
  83. 4. The Script Menu
  84.  
  85. 5. The Supervisor Window
  86.  
  87. 6. A Sample Session
  88.  
  89. 7. PowerPacker 3.0b & the CLI
  90.  
  91. 8. Public screen
  92.  
  93.  
  94. ›1m1. The Packer›0m
  95. ›1m-------------›0m
  96.  
  97. ›3m›1m1.1 An introduction›0m
  98.  
  99.      PowerPacker is a userfriendly command and data cruncher, this means a
  100. menu driven utility that can crunch almost any file on your disks.  It can be
  101. started from the CLI or the WorkBench, just type it's name in the CLI window
  102. or doubleclick it's icon.  PowerPacker will detach itself from the CLI so you
  103. can close the CLI window.  When you use it for the first time it's best to
  104. maintain a certain order in your actions (as we will see in chapter 6 of this
  105. document):
  106.  
  107.   (a) Check the packer options at the beginning of a session (Prefs menu)
  108.   (b) Load the file from disk (Project menu)
  109.   (c) Wait for the file to (de)crunch.
  110.   (d) Save the file back to disk (Project menu)
  111.  
  112.      Apart from crunching, you can also recrunch files that were crunched by
  113. most other crunchers.
  114.      The HunkLab enables you to e.g. force code or data in chip ram.
  115.      The script allows you to e.g. crunch a dozen of files overnight.
  116.  
  117.      Before I demonstrate how to use PowerPacker, let's look at the file
  118. requester and an overview of the menus and capabilities.
  119.  
  120.  
  121. ›3m›1m1.2 The file requester›0m
  122.  
  123.     Whenever you are required to enter a filename, PowerPacker sets up a file
  124. requester.  This requester lists all the files (and their length) of a
  125. selected directory.  You don't have to wait for the directory scan to end, you
  126. can select a file or directory the moment you see it, or you can enter it in
  127. the appropriate string gadget.  If you press <SHIFT-ENTER> in a string gadget
  128. you will activate the other string gadget (file or directory).  To get a list
  129. of all devices connected to your Amiga as well as all the assigns made press
  130. the right mouse button.
  131.     If you wait for the directory scan to end and quit the file requester, the
  132. next time you use it all the files will still be there, so you don't have to
  133. wait for the directory to be read again.  This feature has one disadvantage :
  134. if files are changed or added to the selected directory they won't be shown in
  135. the list, or they will be shown with the wrong filelength, the next time the
  136. requester appears.  Therefore, if you think anything has been changed to the
  137. selected directory, use the 'GET DIR' gadget to re-read the directory.  (E.g.
  138. when you save a crunched file on top of the old one, the old file length will
  139. be shown in the requester.)
  140.      Use the 'Hide/Show .info' gadget to hide or show .info files (workbench
  141. icons).  The 'ALL' and 'CLR' gadget are used to select all files or to clear
  142. the selection of all files, note that these gadgets are not always available.
  143. When the ALL and CLR gadgets are available you can also extend-select
  144. filenames, just press the <SHIFT>-key when selecting files.  The entries are
  145. always sorted and files and directories are seperated.  The requester also
  146. contains an invisible dragbar so you can drag it to another screen position to
  147. see what is underneath.
  148.  
  149.  
  150. ›3m›1m1.3 The basic menus›0m
  151.  
  152. ›3m1.3.1 Project›0m
  153.  
  154.     The project menu contains the file manipulation options.  Most of them
  155. speak for themselves:
  156.  
  157.   Load      ->  Load a file from disk and start the (de)crunching.
  158.                 Files crunched with other (supported) crunchers will be
  159.                 recognized and decrunched.
  160.   Save      ->  Save the (de)crunched or processed file in memory to disk.
  161.   Delete    ->  Delete a file from disk.
  162.   Read      ->  Read an ASCII (text) file using PPMore.
  163.   WorkBench ->  Open or close WorkBench if possible. (Adds 42K!)
  164.   Sleep     ->  Put PowerPacker to sleep on the WorkBench Screen, this
  165.                 frees 40-50K.
  166.                 WARNING: All buffers will be deallocated, so you are advised
  167.                          to save things first.
  168.   About...  ->  Show general information.
  169.   Quit      ->  Quit the program.
  170.  
  171. NOTE: - To read a file PPMore is used. The first time you use 'Read' PPMore
  172.         will probably not be found and PowerPacker will ask you where it is.
  173.         Just use the file requester and select PPMore, save the preferences if
  174.         you want PowerPacker to remember this the next time you run it.
  175.  
  176. ›3m1.3.2 Prefs›0m
  177.  
  178.      The prefs menu contains all the (de)cruncher settings.  You can select
  179. to (de)crunch command files or data files.  If you want the crunched version
  180. of your file to be executable, select 'Command file'.  Now PowerPacker knows
  181. it has to add a decrunch header.  If the file you want to crunch only contains
  182. data (e.g. source codes of your programs), select the 'Data file' option.
  183. This can be handy if you're going to use the PowerPacker CLI commands.  I'll
  184. discuss these commands in chapter 7 of this document.
  185.  
  186. NOTE: - PowerPacker will automatically decrunch a previously crunched
  187.         file.  You don't have to select crunch or decrunch mode anymore as
  188.         in PowerPacker 2.0a.
  189.  
  190.      The 'Decrunch Color' submenu contains the following options :
  191.  
  192.   Color 0   ->  The background color will change while decrunching
  193.   Color 1   ->  The text color changes
  194.   Pointer   ->  Only the mousepointer's color changes
  195.   Scroll    ->  Weird effect (just try it out!)
  196.   None      ->  If your eyes are wearing out.
  197.  
  198.      These options indicate what color will flash when a file is decrunched.
  199. You can change this option before saving a crunched file, so you can save a
  200. version of your crunched program that flashes in color 1, and one that
  201. flashes in the mouse pointer.  The default value is 'Pointer'.
  202.  
  203.      In the efficiency submenu you will find the following possibilities :
  204.  
  205.   Fast      ->  Use for small files, or for quick crunch.
  206.   Mediocre  ->  Better but slower.
  207.   Good      ->  Default, gains 40-50% in most cases.
  208.   Very Good ->  A few percent better than good.
  209.   Best      ->  Gives best results (not always!)
  210.  
  211. NOTE: - 'Best' isn't always the best.  Small files crunch best with
  212.         'Very Good' or even 'Good'.
  213.  
  214.      The 'Speedup Buffer' controls the size of the memory buffer used to
  215. speed up crunching.  You have three choices:
  216.  
  217.   Small     ->  This takes from 2K to 32K  (about 8 times faster than 2.3b)
  218.   Medium    ->  This takes from 4K to 64K  (about 12 times faster)
  219.   Large     ->  This takes around 200K!!   (about 40-50 times faster!)
  220.  
  221. NOTE: - If you have a 512K Amiga you probably can't use the large speedup
  222.         buffer.
  223.  
  224.      The remaining preference switches:
  225.  
  226.   Data Suffix  -> Attach '.pp' suffix to data files after crunching or remove
  227.                   '.pp' after decrunching.  It is advised that you leave this
  228.                   switch on so you can easily spot crunched data files.
  229.   BCPL Header  -> Select this if you want the special decrunch header for BCPL
  230.                   programs (soon to be a thing of the past :-). The Workbench
  231.                   c: directory contains such programs.
  232.   Auto HunkLab -> File is put through hunklab before crunching when you select
  233.                   'Load', this way you can always automatically remove symbol
  234.                   and debug hunks (see further).
  235.   Auto Recrunch-> If the file is crunched with an alien cruncher it is not
  236.                   only decrunched, but it is also recrunched.
  237.   Library Hdr  -> Selects the decrunch header that uses 'powerpacker.library'.
  238.                   This decrunch header is much shorter and better suited for
  239.                   possible future enhancements.  It is therefore recomended
  240.                   that you use it from now on.  SEE IMPORTANT NOTE BELOW!
  241.   Encrypt File -> See section 1.3.3 of this manual.
  242.   Color Crunch -> Flash the selected decrunch color when crunching, giving
  243.                   you an idea what the decrunching will look like (provided
  244.                   that you don't change any options just before saving to
  245.                   disk).
  246.   LED Crunch   -> Your power-LED flashes while crunching, just like the
  247.                   screencolors. Now, you can even turn off your monitor and
  248.                   still see when the cruncher has finished.
  249.   Paging       -> Pause and wait for mouse button when supervisor window
  250.                   fills up.
  251.   Overwrite    -> Don't prompt if it's ok to overwrite a file when saving.
  252.   Verify sleep -> When this switch is on you will be prompted if you are sure
  253.                   you want PowerPacker to go to sleep.
  254.   Sound Alarm  -> When this is on PowerPacker beeps when done with crunching.
  255.  
  256.      Use 'Save Preferences' to save the preferences to your boot disk.  The
  257. preferences will be saved in the file 's:PowerPacker.prefs', this file will
  258. be 94 bytes long.  When PowerPacker 3.0b is first started it will attempt to
  259. load this file and adjust the preferences.
  260.      When you save the preferences the screen colors will also be saved!!  Use
  261. the 'Palette' utility (Workbench 1.3, on Extras 1.3) or the 'Colors' utility
  262. (Workbench 2.0, on Extras 2.0) to change the colors.  Proceed as follows:
  263. Start PowerPacker.  Drag the screen down until you can access the icon of
  264. 'Palette' or 'Colors'.  Make sure the PowerPacker screen is still the
  265. frontmost screen, then double-click the 'Palette' or 'Colors' icon.  You will
  266. now notice that a small palette window has opened on the PowerPacker screen.
  267. Use it to change the screen colors, when you are satified press 'Use'.  Now
  268. select 'Save Preferences' from the 'Prefs' menu.  All done :-) Next time you
  269. use PowerPacker it will open the screen with the new colors.
  270.  
  271. NOTE: - IMPORTANT:  Before you can use the 'Library Hdr' option explained
  272.         above you must copy 'powerpacker.library' to your Libs: directory.
  273.         Kickstart/Workbench 1.2 & 1.3 users should also copy 'LoadPPLib' to
  274.         their C: directory and put 'LoadPPLib' in their startup-sequence
  275.         (before the 'EndCLI >NIL:').  Kickstart/Workbench 2.0 users don't
  276.         need to install 'LoadPPLib'.
  277.         WARNING: 'powerpacker.library' MUST BE IN LIBS: OR PROGRAMS USING THE
  278.         LIBRARY HEADER SIMPLY WON'T RUN !!  NO ERROR CODES OR MESSAGES !!
  279.         If you put 'LoadPPLib' in your startup-sequence there is no problem
  280.         because you will be warned if 'powerpacker.library' is not found.
  281.         But you are not warned if you are a Workbench 2.0 user and you
  282.         haven't put 'LoadPPLib' in your startup-sequence, so take care!
  283.       - While crunching, you can press both mousebuttons at the same time to
  284.         abort.  Keep them pressed down long enough!
  285.  
  286. ›3m1.3.3 Crypt›0m
  287.  
  288.      When the 'Encrypt File' switch is on PowerPacker will not only crunch
  289. files, it will also encrypt them so nobody else but you can decrunch them.
  290. Just before crunching a file PowerPacker will ask you for a password.  You
  291. will be presented with a string gadget with a special feature, it won't show
  292. you what you are typing!  After entering your password you will be asked to
  293. enter it again, this is done to verify that you haven't made a typing error
  294. (watch out you don't make the same error twice :-).
  295.      You can also use the 'Last' gadget to re-enter your last password again,
  296. or the 'Abort' gadget to abort the encryption and just crunch the file.
  297.      When you try to load a crunched encrypted file PowerPacker will once
  298. again prompt you for your password.  If you enter the correct one the file
  299. will be decrypted and decrunched.  If you don't know the password, bad luck,
  300. THERE IS *NO* WAY YOU CAN DECRUNCH THIS FILE !!
  301.      From version 3.0a onwards PowerPacker also encrypts executables. When
  302. you run an encrypted executable you will be prompted for the password. A
  303. small window will open and you have 3 chances to type your password followed
  304. by <ENTER>.  There is no possibility to correct typing mistakes, this would
  305. just have made the decrunch header too long (currently 792 bytes).
  306.  
  307. NOTE: - Encryption can currently not be used in a script.
  308.       - Your password can be up to 16 characters long, any character is
  309.         accepted, lowercase and uppercase are DIFFERENT !!!!
  310.       - Take care when using the 'Last' gadget, be sure to remember what your
  311.         last password was.
  312.       - Don't forget your password !!  It is *IMPOSSIBLE* to decrypt a file
  313.         without the password !!!!!
  314.  
  315.  
  316. ›1m2. Recrunch›0m
  317. ›1m-----------›0m
  318.  
  319. ›3m›1m2.1 How ?›0m
  320.  
  321.      This menu is provided for the people who were using another cruncher or
  322. an older version of PowerPacker.  Just select 'Recrunch File' or 'Recrunch
  323. Always' and load the file.  PowerPacker will start the correct decrunch
  324. algorithm.  If you selected 'Recrunch' PowerPacker will start to crunch the
  325. decrunched file.  If you select 'Recrunch Always' PowerPacker will always
  326. recrunch, even if the file was crunched with this version of PowerPacker.
  327. Useful for recrunching files using a higher efficiency (e.g. recrunch a 'Fast'
  328. crunched file with 'Best').
  329.      If you select 'Load' and PowerPacker recognizes an alien crunched file
  330. it will decrunch it for you, if you have switched 'Auto Recrunch' on the
  331. decrunched file will be recrunched with PowerPacker. The 'Load' menu option
  332. actually replaces the 'Recrunch File' menu option, but the latter one was
  333. left in for old times sake :-)
  334.      Use the 'Change Color' item to change the decrunch color in an already
  335. crunched file to the current decrunch color.  Please note that the file will
  336. be changed on disk, nothing will be loaded into memory.
  337.      Crunchers currently supported are:  'ANC Cruncher', 'TNM Cruncher 1.1',
  338. 'Relokit 1.0', 'HQC Cruncher 2.0', 'MasterCruncher 3.0', 'DragPack 1.0b',
  339. 'TurboSqueeze 5.1', 'Titan Cruncher 1.1', 'Imploder 1.0' and older
  340. PowerPacker files.  If you'd like to see other crunchers supported, send me
  341. the cruncher and some programs crunched with it.  If it is possible to
  342. develop a decrunch algorithm I will include it in the next version of
  343. PowerPacker.
  344.  
  345. NOTE: - 'Decrunch Only' is not 100% guaranteed for 'Relokit 1.0' files,
  346.         'Recrunch' however is 100% ok! (It's a strange world! :-)
  347.       - Several people sent me 'dirty' crunchers, these are crunchers that
  348.         use absolute addresses (an absolute TABOO !!!).  It is impossible
  349.         to develop a decrunch algorithm for these. (In fact, nothing should
  350.         have been crunched with these crunchers in the first place!)
  351.  
  352.  
  353. ›1m3. The Hunklab›0m
  354. ›1m--------------›0m
  355.  
  356. ›3m›1m3.1 Preferences›0m
  357.  
  358.      This menu is not really part of the PowerPacker crunch/decrunch routines
  359. but it wasn't worth writing a separate program for and a HunkLab is after all
  360. a very interesting utility.  You can e.g. use it to remove symbol and debug
  361. hunks from files that wouldn't crunch otherwise.
  362.  
  363.      You can force a program's code, data or BSS (uninitialised data) into
  364. chip ram or you can remove symbol tables and debug information just by
  365. toggling the marker on/off.
  366.  
  367. ›3m3.2 Process file›0m
  368.  
  369.      'Process file' reads the file from disk and changes it according to your
  370. preferences.  To save the processed file, use 'Save' from the Project menu.
  371.      'Process & Crunch' will process the file and crunch the file afterwards
  372. (if possible).  To save use 'Save' in the Project menu.
  373.  
  374. NOTE: - Debug and symbol hunks are only used in debuggers, so you can safely
  375.         remove them from a program. (Unless you want to debug the program.)
  376.  
  377.  
  378. ›1m4. The Script Menu›0m
  379. ›1m------------------›0m
  380.  
  381.      The script is something that will save you a lot of time, it allows you
  382. to record a number of different commands to be executed after each other.  It
  383. is ideal for crunching a lot of files in one go.  It also offers you the
  384. possibility to delete the source files after crunching, so you can easily
  385. crunch a directory full of data files and delete the source files after the
  386. crunched files with .pp suffix are saved. Menu options are:
  387.  
  388.      'Clear Script' and 'List Script':
  389.           will do just that.
  390.      'Set # commands':
  391.           select to be prompted a new maximum number of commands to be
  392.           recorded. (Default is 80)
  393.      'Script Log File':
  394.           is used to specify a file to redirect output to.  If you cancel
  395.           the requester no log file is used.
  396.      'Destination Dir':
  397.           is used to specify the directory to save to.  It is ghosted in
  398.           normal use.
  399.      'Start Recording':
  400.           is used to start the recording of the script. If the script was
  401.           empty you will be asked for the destination directory.
  402.               After selecting the destination you can start entering the
  403.           script commands.  Everything that is ghosted is not available as a
  404.           command.  Just enter everything as if you were actually using
  405.           PowerPacker, with one big difference: you can select more than one
  406.           file at a time. Just press the <SHIFT> key to extend-select other
  407.           files. When you then press OK all these files will be entered in
  408.           the script.  You can also use the ALL and CLR gadgets as described
  409.           in the file requester section.
  410.           NOTE: - You can still change the source and destination dir while
  411.                   recording.
  412.           Every command you enter will be displayed in the supervisor window.
  413.      'Stop Recording':
  414.           is used to exit the recording mode.
  415.      'Delete Last':
  416.           will delete the last command after a confirmation.
  417.      'Delete Command':
  418.           to delete a specific command, you will be prompted for the command
  419.           number.
  420.      'Insert Command':
  421.           to insert a new command after another command. You will be asked
  422.           after which command you want to insert something. Enter the command
  423.           number.
  424.  
  425.      'Skip Crunched':
  426.           when you enter this command in the script PowerPacker will skip
  427.           crunched files rather than decrunch them. Select again to turn off.
  428.      'Delete Source':
  429.           this command tells PowerPacker to delete the source file after it
  430.           has crunched (and saved) it to the destination. Select again to
  431.           turn off.
  432.      'Delete Quick':
  433.           the same as the previous command but now the source is deleted
  434.           BEFORE the crunched file is saved. (useful for when source and
  435.           destination are on the same disk and the disk is very full)
  436.           Select again to turn off.
  437.  
  438.      'Execute Script':
  439.           will start the playback of the script commands.  If you press the
  440.           menu button a requester will appear to ask you if you want to abort
  441.           the script execution.  After executing the script a request to
  442.           clear the script will appear.
  443.  
  444. NOTE: - The screen turns grey to indicate a script is executing.
  445.       - While executing a script, PowerPacker will always act destructive!
  446.         Files will allways be overwritten and deleted, no confirmations!!
  447.       - After the script has executed you will be presented with the script
  448.         statistics.  This way you can see what the overall gain was.
  449.  
  450.  
  451. ›1m5. The Supervisor Window›0m
  452. ›1m------------------------›0m
  453.  
  454.      This window displays all kind of useful information like the file
  455. status, crunch messages, and error messages.  You can follow all steps, from
  456. the original file that is loaded into memory, to the final crunched version
  457. on disk.  When an executable file is loaded, its hunk information is
  458. displayed.  This information is rather technical, but it can be useful for
  459. programmers.  If you're not interested, just ignore it.
  460.  
  461.  
  462. ›1m6. A Sample Session›0m
  463. ›1m-------------------›0m
  464.  
  465.      Now that I have explained PowerPacker's capabilities, it's time for
  466. a little demonstation.  Let's say we want to crunch the 'CLI' command in the
  467. System directory on your Workbench 1.2 disk.
  468.  
  469.      Select 'Pointer' in the Prefs/Decrunch Color menu (When I wrote this
  470. text, it was very late and I couldn't stand the other decrunch colors
  471. anymore!)
  472.  
  473.      Set 'Prefs' to 'Command file'.  Now select 'Load' in the Project menu
  474. (the file requester will appear), insert your WorkBench 1.2 disk and choose
  475. the 'CLI' command in the system directory.  Now you'll see a lot of hunk
  476. (or junk ?? :-) information about the CLI command:
  477.  
  478.                                                                              
  479.      Scanning file 'df0:System/CLI'...                                       
  480.      Loading command file...                                                 
  481.                                                                              
  482.      Hunk_header (0x03F3)                                                    
  483.         9 hunks (0 to 8).                                                    
  484.      Hunk  0 : Hunk_code (0x03E9)     (524 bytes)                            
  485.                Hunk_reloc32 (0x03EC)                                         
  486.      Hunk  1 : Hunk_data (0x03EA)     (428 bytes, 0 BSS)                     
  487.      Hunk  2 : Hunk_code (0x03E9)     (472 bytes)                            
  488.                Hunk_reloc32 (0x03EC)                                         
  489.      Hunk  3 : Hunk_data (0x03EA)     (52 bytes, 0 BSS)                      
  490.      Hunk  4 : Hunk_code (0x03E9)     (16 bytes)                             
  491.      Hunk  5 : Hunk_code (0x03E9)     (0 bytes)                              
  492.      Hunk  6 : Hunk_code (0x03E9)     (196 bytes)                            
  493.                Hunk_reloc32 (0x03EC)                                         
  494.      Hunk  7 : Hunk_code (0x03E9)     (68 bytes)                             
  495.                Hunk_reloc32 (0x03EC)                                         
  496.      Hunk  8 : Hunk_data (0x03EA)     (0 bytes, 0 BSS)                       
  497.                                                                              
  498.      Crunching command file...                                               
  499.      Press left and right button to abort.                                   
  500.      Crunching, please wait.                                                 
  501.                                                                              
  503.      The cruncher displays the percentage of the file already crunched and
  504. the gain so far. After some time your screen will look like this:
  505.  
  506.                                                                              
  507.      100% crunched.                                                          
  508.      Done.                                                                   
  509.      Original length : 2356 bytes.                                           
  510.      Crunched length : 1204 (1804) bytes.                                    
  511.      Gained 49% (1152 bytes) !                                               
  512.                                                                              
  514.      The only thing you have to do now is save this back to disk as an
  515. executable file.  Now enjoy the crunched CLI command.
  516.  
  517.  
  518. ›1m7. PowerPacker 3.0b & the CLI›0m
  519. ›1m-----------------------------›0m
  520.  
  521.      For your convenience, I have also written two CLI commands, one to
  522. crunch and one to decrunch data files.
  523.      These CLI commands use the magnificent ARP library.  This means they
  524. are very powerful : wildcards are fully supported, options can be entered in
  525. any order, directories will be created when needed, etc...  Make sure the
  526. arp.library is in your LIBS:  directory when you run these commands.
  527.      A usage line is given by typing 'Crunch' or 'Decrunch' without
  528. arguments.  You'll get something like this:
  529. _____________________________________________________________________________
  530.  
  531. 1> Crunch
  532. POWER-PACKER 3.0a Data Cruncher.
  533.   Written by Nico François (PowerPeak)
  534. Usage : Crunch <source> [<destination>] [EFFICIENCY 1-5] [COLOR 0-4] [CRYPT]
  535.                                     [NOSUFFIX] [NOLED] [NOPER] [SLOW] [FAST]
  536. With:
  537.  EFFICIENCY: 1 = Fast, 2 = Mediocre, 3 = Good (def), 4 = Very Good, 5 = Best
  538.  COLOR     : 0/1 = Color 0/1, 2 = Pointer (def), 3 = Scroll, 4 = None
  539.  CRYPT     : Encrypt file.
  540.  NOSUFFIX  : No '.pp' suffix.
  541.  NOLED     : No flashing led.
  542.  NOPER     : No percentage.
  543.  FAST      : Fast crunch.
  544.  SLOW      : Slower crunch.
  545. Hit ^C to abort, ^E or ^F to abort crunching only.
  546.  
  547. 1> Decrunch
  548. POWER-PACKER 3.0a Data Decruncher.
  549.   Written by Nico François (PowerPeak)
  550. Usage : Decrunch <source> <destination> [COLOR 0-4] [OPT B|F] [SKIP] [QUIET]
  551. With:
  552.    COLOR: 0/1 = Color 0/1, 2 = Pointer (def), 3 = Scroll, 4 = None
  553.    SKIP : Skip uncrunched files.
  554.    QUIET: Be quiet.
  555. If <destination> is '*' or is omited, files will be typed to Output().
  556. Options effective when typing:
  557.    OPT B: print a banner before and
  558.    OPT F: print a formfeed after each file.
  559. Hit ^C to abort, ^E or ^F to abort typing only.
  560.  
  561. 1>
  562. _____________________________________________________________________________
  563.  
  564.      These commands are useful to be included in your startup-sequence or to
  565. read crunched text files quickly.
  566.  
  567.   Some examples:
  568.  
  569.      Crunch df0:source/*.c TO ram:source COL 4 NOLED
  570.  
  571.      This will result in a crunching of every C program in the df0:source
  572. directory.  If the ram:source directory exists the files will be saved there,
  573. if it doesn't it will be created if there is more than one C program in
  574. df0:source.  The '.pp' suffix will be attached to the filenames.  The led
  575. will not flicker, no crunch color is used.
  576.  
  577.      Decrunch >PRT: QUIET dh0:progs/*.asm.pp OPT BF COL 3
  578.  
  579.      Every crunched assembly program will be decrunched and printed, before
  580. each file a banner will be printed, each file will start on a new page.  If
  581. the file is encrypted you will be prompted for a password.  It is very
  582. important that you use the QUIET option here, if you don't the copyright and
  583. information lines will also be printed.  The mouse pointer will flash while
  584. decrunching.
  585.  
  586. NOTE: - These commands only (de)crunch DATA files!!!!  (So to (de)crunch
  587.         executable files, you'll still have to use PowerPacker).
  588.       - The Crunch command defaults to using the large crunch buffer, you can
  589.         use the medium buffer by selecting FAST and the small buffer by
  590.         selecting SLOW.
  591.  
  592.  
  593. ›1m8. Public screen›0m
  594. ›1m----------------›0m
  595.  
  596.      If your Amiga has the Kickstart 2.0 ROMs PowerPacker will make its
  597. screen public.  This means that other programs that support public screens
  598. will be able to open windows on the PowerPacker screen.  PowerPacker will
  599. only close its screen once ALL these visitor windows are closed.
  600.      The name of the public screen is 'PowerPacker' (mind case!).
  601.  
  602. NOTE: - If you run PowerPacker more than once only the first PowerPacker will
  603.         make its screen public.  All other PowerPackers will have a private
  604.         screen (the screen title will show this).
  605.  
  606.  
  607.                                              Enjoy this program!
  608.  
  609.  
  610.                               PROGRAM HISTORY:
  611.  
  612. *****************************************************************************
  613. VERSION 1.0a
  614.  
  615.      First release.
  616.  
  617. *****************************************************************************
  618. VERSION 1.1a
  619.  
  620.      Fixed bugs.
  621.      Improved crunch algorithm by about 5%.
  622.      'Delete' and 'Multitask' added.
  623.      Better menu structure.
  624.      Improved the file requester.
  625.      Written CLI commands.
  626.  
  627. *****************************************************************************
  628. VERSION 2.0a
  629.  
  630.      Fixed some more bugs.
  631.      Added buffer and automatic device-list to the file requester.
  632.      Added 'LED Crunch', useful for turning the monitor off while crunching,
  633.      and 'Paging'.
  634.      New header, bug fixed. (1.1 didn't free mem when started from WorkBench)
  635.      Added the hunklab.
  636.      Improved CLI commands.
  637.  
  638. *****************************************************************************
  639. VERSION 2.1a
  640.  
  641.      Fixed last bug in header (2.0 crashed when you were out of memory, oops)
  642.      Added script feature, now possible to crunch files overnight.
  643.      Improved requesters.
  644.      Automatic crunch/decrunch.
  645.      Improved menu structure considerably.
  646.      Intelligent recrunch implemented.
  647.      Automatic crunch/decrunch.
  648.      Added 'Color Crunch' option.
  649.      New efficiency 'Best' added.
  650.  
  651. *****************************************************************************
  652. VERSION 2.1b
  653.  
  654.      Bug fixed in script abort.
  655.      Added ability to open a log file during script execution.
  656.      Now possible to recrunch PowerPacker files with a higher efficiency.
  657.      Recrunch detects unsupported crunchers a lot faster.
  658.      PowerPacker now automatically opens a PAL/NTSC screen.
  659.  
  660. *****************************************************************************
  661. VERSION 2.2a
  662.  
  663.      All known bugs (or better, undocumented features) fixed.
  664.      'Sleep' mode implemented, useful for multitasking freaks.
  665.      While crunching the gain percentage so far is displayed.
  666.      Recrunch now supports 'HQC Cruncher 2.0', 'MasterCruncher 3.0'
  667.        and 'Dragpack 1.0'.
  668.      New graphics in title.
  669.  
  670. *****************************************************************************
  671. VERSION 2.3a
  672.  
  673.      PowerPacker detaches itself from the CLI, so the CLI window can be
  674.        closed or used for other things.
  675.      CLI commands are greatly enhanced, they now use ARP.
  676.      New switch : 'Overwrite' to surpress 'OK to overwrite ?' request.
  677.      File requester now able to sort files, 'Sort files' switch.
  678.      By popular demand: encryption of data files is now possible using the
  679.        new 'Encrypt Data' switch. Encryption should be IMPOSSIBLE to crack !!
  680.      Also by popular demand: Now possible to save preferences to boot disk.
  681.      More memory efficient decrunch and recrunch of PowerPacker files.
  682.      Decrunch source included, so other programs could be written that
  683.        would load data files crunched with PowerPacker.
  684.      'Data Suffix' switch to improve adding/removing of '.pp' suffix.
  685.      Decrunch color default 'Pointer'.
  686.      Improved scanning of files when loading or recrunching.
  687.      Fixed small bug (version 2.2a lost 256 bytes every time it was run).
  688.      More info in about window.
  689.  
  690. *****************************************************************************
  691. VERSION 2.3b
  692.  
  693.      Added 'Change Color' in 'Recrunch' menu to change the decrunch color
  694.        of an already crunched file.
  695.      PowerPacker now starts up a process with priority -1.  It now no longer
  696.        slows down the rest of the system (e.g. a CLI) when crunching.
  697.      New 'Verify sleep' switch to toggle the requester that verifies the
  698.        sleep function on/off.
  699.      Now possible to skip files already crunched with PowerPacker in script.
  700.      Bug fixed in 'Recrunch', ANC files were no longer recognized. Oops :-)
  701.  
  702. #############################################################################
  703. VERSION 3.0a
  704.  
  705.      FIRST COMMERCIAL VERSION, *MAJOR* UPDATE !!
  706.  
  707.      FAST !!!!  40-50 times faster crunching than previous versions !!!
  708.        Three different speeds selectable. Multitask switch removed, no longer
  709.        needed.
  710.      Full overlay support !!! (crunches e.g. DPaint III)
  711.      Decrunching 20% faster.
  712.      Crunches up to 5% (yippee :-)
  713.      Recrunch now supports 'TurboSqueeze', 'Titanics' and 'Imploder'.
  714.      Decrunch header more memory efficient, you can now also decrunch and
  715.        run programs larger than 250K on a 512K machine.
  716.      Script much more powerful:
  717.        - Insert #, Delete #.
  718.        - New commands : Skip crunched files.
  719.                         Delete source files (safe or quick).
  720.        - Maximum number of script commands user-definable.
  721.      Automatic hunklab and automatic recrunch switches.
  722.      Recrunches data files.
  723.      Encrypted executables !!!!!  Protect your programs as well as data !
  724.      File requester much improved:
  725.        - user-friendlier sorting, no more file-chasing !
  726.        - files / directories seperated.
  727.        - show/hide .info files
  728.        - extended selection possible (including ALL and CLEAR gadgets, for
  729.          use in script)
  730.        - drag-bar, position is remembered for the next time you use it.
  731.        - shows all devices attached as well as all assigns made
  732.        - 7 entries on screen at once (previously 6)
  733.        - supports SHIFT-ENTER "standard" to jump from file to dir gadget
  734.      Switch for BCPL programs added (WorkBench 1.3 c: directory)
  735.      Position of the small sleep-window is remembered, so the window will
  736.        open where you last left it.
  737.      Read (crunched) text files from within PowerPacker. (using PPMore)
  738.      Sound alarm.
  739.      Extended menu selecting now supported.
  740.      Script prints statistics after execution.
  741.      Before saving, length of crunched file is compared to original length.
  742.      Abort now only works when PowerPacker screen is active, no more problems
  743.        when multitasking.
  744.      CLI commands improved:
  745.        - are reentrant, can be made resident and run from several CLI's at
  746.          once.
  747.        - also 40-50 times faster
  748.        - shorter code
  749.        - 'Crunch NOSUFFIX' bug fixed, used to delete original file if source
  750.          and destination where the same and crunching was aborted.
  751.  
  752. #############################################################################
  753. VERSION 3.0b
  754.  
  755.      Revamped user interface, all new 'Workbench 2.0' 3D look :^)  Still runs
  756.        on Kickstart 1.3!
  757.      Supports 'powerpacker.library'.  You can now save executables with a
  758.        much smaller decrunch header that uses 'powerpacker.library'.
  759.      Screen colors are now saved with preferences so they can be changed by
  760.        the user.
  761.      Small bug fixed in script auto-delete.  Wouldn't delete data files after
  762.        DE-crunching them.
  763.      When run on Kickstart 2.0 the PowerPacker screen is made public.
  764.      Some bug fixes:
  765.        Fixed bug in 'Auto Recrunch', it simply didn't work :-(
  766.        Script now correctly records 'Auto Recrunch'.
  767.        Recrunching of data files is now fully functional.
  768.  
  769. #############################################################################
  770.  
  771. PowerPacker 3.0b written by Nico François (Yes, Nico is my first name :-)
  772. Special thanks go to - Luc Pauwels for the icons and writing the 2.0a manual,
  773.                      - Jorrit Tyberghein, Ives Aerts and Philip Marivoet for
  774.                        the extensive debugging.
  775.                      - Christian Morant for the late night 'turbo' hack :-)
  776.                      - Kenny for his invaluable suggestions.
  777.                      - and a very special thank you to all the people who
  778.                        supported the shareware versions of PowerPacker.
  779.  
  780. (c) 1990 Nico François / Power Peak
  781.  
  782.                                    //
  783.                        Thanks to \X/ Amiga for being the best computer ever!
  784.  
  785.